---
title: "Quickstart"
sidebarTitle: "Quickstart"
description: "Inspect your backend requests with just one command"
icon: "rocket"
---

Subtrace is the network inspector for your backend. With just one command, you'll be able to see every HTTP request in your backend.

Follow this guide to add it to your codebase in under two minutes.

<Steps>
  <Step title="Install the Subtrace CLI">
    Open a terminal and install the Subtrace CLI:

    ```bash
    curl -fsSL https://subtrace.dev/install.sh | sh
    ```
  </Step>

  <Step title="Start with Subtrace">
    Start your backend like you normally do but wrap the command with Subtrace:

    <CodeGroup>
      ```bash Generic
      subtrace run -- my-app-command
      ```

      ```bash Node
      subtrace run -- node server.js
      ```

      ```bash Go
      subtrace run -- go run .
      ```

      ```bash FastAPI
      subtrace run -- fastapi run main.py
      ```

      ```bash Flask
      subtrace run -- flask --app hello run
      ```

      ```bash Gunicorn
      subtrace run -- gunicorn -w 4 myapp:app
      ```

      ```bash Laravel
      subtrace run -- php artisan serve
      ```
    </CodeGroup>

    <Expandable title="example output">
      <img className="rounded-xl" src="/images/quickstart-link.png" />
    </Expandable>
  </Step>

  <Step title="Watch">
    Open the `subt.link` URL in your browser to watch a live stream of your
    backend server's network logs!

    <img className="rounded-xl" src="/images/quickstart-screenshot.png" />
  </Step>
</Steps>

## Next steps

Check out the guide specific to your backend for next steps:

- **Node**: [Express.js](/nodejs-express)
- **Python**: [FastAPI](/python-fastapi), [Flask](/python-flask), [Gunicorn](/python-gunicorn)
- **Others**: [Go](/golang), [Laravel](/php-laravel)

If your language or framework isn't listed here, let us know and we can help
you get started. Join our [discord server](https://subtrace.dev/discord) or
email us at [support@subtrace.dev](support@subtrace.dev) for assistance.

## Troubleshooting

<AccordionGroup>
  <Accordion title='error: subtrace: missing SYS_PTRACE capability'>
    Add the `SYS_PTRACE` capability to your container.

    <CodeGroup>
      ```bash Docker (docker run)
      docker run --cap-add=SYS_PTRACE ...
      ```

      ```yaml Docker Compose
      services:
        my-app:
          cap_add:
            - SYS_PTRACE
      ```
    </CodeGroup>

    See the [full guide](/ptrace) for other platforms and environments.
  </Accordion>
</AccordionGroup>
